<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-US">
<head>
<!-- GenHTML revision 25226-->
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<title>The simplegreeting CDI Example - The Java EE 6 Tutorial</title>
<meta name="robots" content="index,follow">
<meta name="robots" content="index,follow">
<meta name="date" content="2011-03-01">
<link rel="stylesheet" type="text/css" href="css/default.css">
<link rel="stylesheet" type="text/css" href="css/ipg.css">
<link rel="stylesheet" type="text/css" href="css/javaeetutorial.css">
</head>

<body>

<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
   <tr valign="top">
      <td width="400px"><p class="toc level1"><a href="docinfo.html">Document Information</a></p>
<p class="toc level1 tocsp"><a href="gexaf.html">Preface</a></p>
<p class="toc level1 tocsp"><a href="gfirp.html">Part&nbsp;I&nbsp;Introduction</a></p>
<p class="toc level2"><a href="bnaaw.html">1.&nbsp;&nbsp;Overview</a></p>
<p class="toc level2"><a href="gfiud.html">2.&nbsp;&nbsp;Using the Tutorial Examples</a></p>
<p class="toc level1 tocsp"><a href="bnadp.html">Part&nbsp;II&nbsp;The Web Tier</a></p>
<p class="toc level2"><a href="bnadr.html">3.&nbsp;&nbsp;Getting Started with Web Applications</a></p>
<p class="toc level2"><a href="bnaph.html">4.&nbsp;&nbsp;JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="giepx.html">5.&nbsp;&nbsp;Introduction to Facelets</a></p>
<p class="toc level2"><a href="gjddd.html">6.&nbsp;&nbsp;Expression Language</a></p>
<p class="toc level2"><a href="bnaqz.html">7.&nbsp;&nbsp;Using JavaServer Faces Technology in Web Pages</a></p>
<p class="toc level2"><a href="gjcut.html">8.&nbsp;&nbsp;Using Converters, Listeners, and Validators</a></p>
<p class="toc level2"><a href="bnatx.html">9.&nbsp;&nbsp;Developing with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="gkmaa.html">10.&nbsp;&nbsp;JavaServer Faces Technology Advanced Concepts</a></p>
<p class="toc level2"><a href="bnawo.html">11.&nbsp;&nbsp;Configuring JavaServer Faces Applications</a></p>
<p class="toc level2"><a href="gkiow.html">12.&nbsp;&nbsp;Using Ajax with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="gkhxa.html">13.&nbsp;&nbsp;Advanced Composite Components</a></p>
<p class="toc level2"><a href="bnavg.html">14.&nbsp;&nbsp;Creating Custom UI Components</a></p>
<p class="toc level2"><a href="bnafd.html">15.&nbsp;&nbsp;Java Servlet Technology</a></p>
<p class="toc level2"><a href="bnaxu.html">16.&nbsp;&nbsp;Internationalizing and Localizing Web Applications</a></p>
<p class="toc level1 tocsp"><a href="bnayk.html">Part&nbsp;III&nbsp;Web Services</a></p>
<p class="toc level2"><a href="gijti.html">17.&nbsp;&nbsp;Introduction to Web Services</a></p>
<p class="toc level2"><a href="bnayl.html">18.&nbsp;&nbsp;Building Web Services with JAX-WS</a></p>
<p class="toc level2"><a href="giepu.html">19.&nbsp;&nbsp;Building RESTful Web Services with JAX-RS</a></p>
<p class="toc level2"><a href="gjjxe.html">20.&nbsp;&nbsp;Advanced JAX-RS Features</a></p>
<p class="toc level2"><a href="gkojl.html">21.&nbsp;&nbsp;Running the Advanced JAX-RS Example Application</a></p>
<p class="toc level1 tocsp"><a href="bnblr.html">Part&nbsp;IV&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="gijsz.html">22.&nbsp;&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="gijre.html">23.&nbsp;&nbsp;Getting Started with Enterprise Beans</a></p>
<p class="toc level2"><a href="gijrb.html">24.&nbsp;&nbsp;Running the Enterprise Bean Examples</a></p>
<p class="toc level2"><a href="bnbpk.html">25.&nbsp;&nbsp;A Message-Driven Bean Example</a></p>
<p class="toc level2"><a href="gkcqz.html">26.&nbsp;&nbsp;Using the Embedded Enterprise Bean Container</a></p>
<p class="toc level2"><a href="gkidz.html">27.&nbsp;&nbsp;Using Asynchronous Method Invocation in Session Beans</a></p>
<p class="toc level1 tocsp"><a href="gjbnr.html">Part&nbsp;V&nbsp;Contexts and Dependency Injection for the Java EE Platform</a></p>
<p class="toc level2"><a href="giwhb.html">28.&nbsp;&nbsp;Introduction to Contexts and Dependency Injection for the Java EE Platform</a></p>
<p class="toc level2"><a href="gjbls.html">29.&nbsp;&nbsp;Running the Basic Contexts and Dependency Injection Examples</a></p>
<div id="scrolltoc" class="onpage">
<p class="toc level3"><a href="">The <tt>simplegreeting</tt> CDI Example</a></p>
<p class="toc level4"><a href="#gjcqs">The <tt>simplegreeting</tt> Source Files</a></p>
<p class="toc level4"><a href="#gjdoj">The Facelets Template and Page</a></p>
<p class="toc level4"><a href="#gjcvh">Configuration Files</a></p>
<p class="toc level4"><a href="#gjcym">Building, Packaging, Deploying, and Running the <tt>simplegreeting</tt> CDI Example</a></p>
<p class="toc level5"><a href="#gjcxp">To Build, Package, and Deploy the <tt>simplegreeting</tt> Example Using NetBeans IDE</a></p>
<p class="toc level5"><a href="#gjczt">To Build, Package, and Deploy the <tt>simplegreeting</tt> Example Using Ant</a></p>
<p class="toc level5"><a href="#gjcze">To Run the <tt>simplegreeting</tt> Example</a></p>
</div>
<p class="toc level3 tocsp"><a href="gjcxv.html">The <tt>guessnumber</tt> CDI Example</a></p>
<p class="toc level4"><a href="gjcxv.html#gjdju">The <tt>guessnumber</tt> Source Files</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdjp">The <tt>@MaxNumber</tt> and <tt>@Random</tt> Qualifier Interfaces</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdjn">The <tt>Generator</tt> Managed Bean</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdhy">The <tt>UserNumberBean</tt> Managed Bean</a></p>
<p class="toc level4 tocsp"><a href="gjcxv.html#gjdon">The Facelets Page</a></p>
<p class="toc level4"><a href="gjcxv.html#gjdpw">Building, Packaging, Deploying, and Running the <tt>guessnumber</tt> CDI Example</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdps">To Build, Package, and Deploy the <tt>guessnumber</tt> Example Using NetBeans IDE</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdpr">To Build, Package, and Deploy the <tt>guessnumber</tt> Example Using Ant</a></p>
<p class="toc level5"><a href="gjcxv.html#gjdqb">To Run the <tt>guessnumber</tt> Example</a></p>
<p class="toc level2 tocsp"><a href="gjehi.html">30.&nbsp;&nbsp;Contexts and Dependency Injection for the Java EE Platform: Advanced Topics</a></p>
<p class="toc level2"><a href="gkhre.html">31.&nbsp;&nbsp;Running the Advanced Contexts and Dependency Injection Examples</a></p>
<p class="toc level1 tocsp"><a href="bnbpy.html">Part&nbsp;VI&nbsp;Persistence</a></p>
<p class="toc level2"><a href="bnbpz.html">32.&nbsp;&nbsp;Introduction to the Java Persistence API</a></p>
<p class="toc level2"><a href="gijst.html">33.&nbsp;&nbsp;Running the Persistence Examples</a></p>
<p class="toc level2"><a href="bnbtg.html">34.&nbsp;&nbsp;The Java Persistence Query Language</a></p>
<p class="toc level2"><a href="gjitv.html">35.&nbsp;&nbsp;Using the Criteria API to Create Queries</a></p>
<p class="toc level2"><a href="gkjiq.html">36.&nbsp;&nbsp;Creating and Using String-Based Criteria Queries</a></p>
<p class="toc level2"><a href="gkjjf.html">37.&nbsp;&nbsp;Controlling Concurrent Access to Entity Data with Locking</a></p>
<p class="toc level2"><a href="gkjia.html">38.&nbsp;&nbsp;Improving the Performance of Java Persistence API Applications By Setting a Second-Level Cache</a></p>
<p class="toc level1 tocsp"><a href="gijrp.html">Part&nbsp;VII&nbsp;Security</a></p>
<p class="toc level2"><a href="bnbwj.html">39.&nbsp;&nbsp;Introduction to Security in the Java EE Platform</a></p>
<p class="toc level2"><a href="bncas.html">40.&nbsp;&nbsp;Getting Started Securing Web Applications</a></p>
<p class="toc level2"><a href="bnbyk.html">41.&nbsp;&nbsp;Getting Started Securing Enterprise Applications</a></p>
<p class="toc level1 tocsp"><a href="gijue.html">Part&nbsp;VIII&nbsp;Java EE Supporting Technologies</a></p>
<p class="toc level2"><a href="gijto.html">42.&nbsp;&nbsp;Introduction to Java EE Supporting Technologies</a></p>
<p class="toc level2"><a href="bncih.html">43.&nbsp;&nbsp;Transactions</a></p>
<p class="toc level2"><a href="bncjh.html">44.&nbsp;&nbsp;Resource Connections</a></p>
<p class="toc level2"><a href="bncdq.html">45.&nbsp;&nbsp;Java Message Service Concepts</a></p>
<p class="toc level2"><a href="bncgv.html">46.&nbsp;&nbsp;Java Message Service Examples</a></p>
<p class="toc level2"><a href="gkahp.html">47.&nbsp;&nbsp;Advanced Bean Validation Concepts and Examples</a></p>
<p class="toc level2"><a href="gkeed.html">48.&nbsp;&nbsp;Using Java EE Interceptors</a></p>
<p class="toc level1 tocsp"><a href="gkgjw.html">Part&nbsp;IX&nbsp;Case Studies</a></p>
<p class="toc level2"><a href="gkaee.html">49.&nbsp;&nbsp;Duke's Tutoring Case Study Example</a></p>
<p class="toc level1 tocsp"><a href="idx-1.html">Index</a></p>
</td>
      <td width="10px">&nbsp;</td>
      <td>
         <div class="header">
             <div class="banner">
                <table width="100%" border="0" cellpadding="5" cellspacing="0">
                   <tbody>
                      <tr>
                         <td valign="bottom"><p class="Banner">The Java EE 6 Tutorial
</p></td>
                         <td align="right"  valign="bottom"><img src="graphics/javalogo.png" alt="Java Coffee Cup logo"></td>
                      </tr>
                   </tbody>
                </table>
             </div>

             <div class="header-links">
	         <a href="./index.html">Home</a> | 
<a href="../information/download.html">Download</a> | 
<a href="./javaeetutorial6.pdf">PDF</a> | 
<a href="../information/faq.html">FAQ</a> | 
<a href="http://download.oracle.com/javaee/feedback.htm">Feedback</a>

             </div>
             <div class="navigation">
                 <a href="gjbls.html"><img src="graphics/leftButton.gif" border="0" alt="Previous" title="Previous"></a>
                 <a href="p1.html"><img src="graphics/upButton.gif" border="0" alt="Contents" title="Contents"></a>
                 <a href="gjcxv.html"><img src="graphics/rightButton.gif" border="0" alt="Next" title="Next"></a>
             </div>
         </div>

	 <div class="maincontent">      	 
             

<a name="gjbju"></a><h2>The <tt>simplegreeting</tt> CDI Example</h2>
<p>The  <tt>simplegreeting</tt> example illustrates some of the most basic features of CDI:
scopes, qualifiers, bean injection, and accessing a managed bean in a JavaServer Faces
application. When you run the example, you click a button that presents either
a formal or an informal greeting, depending on how you edited one of
the classes. The example includes four source files, a Facelets page and template,
and configuration files.</p>



<a name="gjcqs"></a><h3>The <tt>simplegreeting</tt> Source Files</h3>
<p>The four source files for the <tt>simplegreeting</tt> example are</p>


<ul><li><p>The default <tt>Greeting</tt> class, shown in <a href="gizks.html">Beans as Injectable Objects</a></p>

</li>
<li><p>The <tt>@Informal</tt> qualifier interface definition and the <tt>InformalGreeting</tt> class that implements the interface, both shown in <a href="gjbck.html">Using Qualifiers</a></p>

</li>
<li><p>The <tt>Printer</tt> managed bean class, which injects one of the two interfaces, shown in full in <a href="gjbbp.html">Adding Setter and Getter Methods</a></p>

</li></ul>
<p>The source files are located in the following directory:</p>

<p><tt></tt><i>tut-install</i><tt>/examples/cdi/simplegreeting/src/java/greetings</tt></p>



<a name="gjdoj"></a><h3>The Facelets Template and Page</h3>
<p>To use the managed bean in a simple Facelets application, you can
use a very simple template file and <tt>index.xhtml</tt> page. The template page, <tt>template.xhtml</tt>, looks
like this:</p>

<pre>&lt;?xml version='1.0' encoding='UTF-8' ?>
&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
&lt;html lang="en"
      xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:ui="http://java.sun.com/jsf/facelets">
    &lt;h:head>
        &lt;meta http-equiv="Content-Type" 
              content="text/html; charset=UTF-8"/>
        &lt;link href="resources/css/default.css" 
              rel="stylesheet" type="text/css"/>
        &lt;title>
            &lt;ui:insert name="title">Default Title&lt;/ui:insert>
        &lt;/title>
    &lt;/h:head>

    &lt;body>
        &lt;div id="container">
            &lt;div id="header">
                &lt;h2>&lt;ui:insert name="head">Head&lt;/ui:insert>&lt;/h2>
            &lt;/div>

            &lt;div id="space">
                &lt;p>&lt;/p>
            &lt;/div>

            &lt;div id="content">
                &lt;ui:insert name="content"/>
            &lt;/div>
        &lt;/div>
    &lt;/body>
&lt;/html></pre><p>To create the Facelets page, you can redefine the title and head,
then add a small form to the content:</p>

<pre>&lt;?xml version='1.0' encoding='UTF-8' ?>
&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
&lt;html lang="en"
      xmlns="http://www.w3.org/1999/xhtml"
      xmlns:ui="http://java.sun.com/jsf/facelets"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core">
    &lt;ui:composition template="/template.xhtml">

        &lt;ui:define name="title">Simple Greeting&lt;/ui:define>
        &lt;ui:define name="head">Simple Greeting&lt;/ui:define>
        &lt;ui:define name="content">
            &lt;h:form id="greetme">
               &lt;p>&lt;h:outputLabel value="Enter your name: " for="name"/>
                  &lt;h:inputText id="name" value="#{printer.name}"/>&lt;/p>
               &lt;p>&lt;h:commandButton value="Say Hello" 
                                   action="#{printer.createSalutation}"/>&lt;/p>
               &lt;p>&lt;h:outputText value="#{printer.salutation}"/> &lt;/p>
            &lt;/h:form>
        &lt;/ui:define>

    &lt;/ui:composition>
&lt;/html></pre><p>The form asks the user to type a name. The button is
labeled Say Hello, and the action defined for it is to call the
<tt>createSalutation</tt> method of the <tt>Printer</tt> managed bean. This method in turn calls the <tt>greet</tt>
method of the defined <tt>Greeting</tt> class.</p>

<p>The output text for the form is the value of the greeting
returned by the setter method. Depending on whether the default or the <tt>@Informal</tt>
version of the greeting is injected, this is one of the following, where
<i>name</i> is the name typed by the user:</p>

<pre>Hello, <i>name</i>.</pre><pre>Hi, <i>name</i>!</pre><p>The Facelets page and template are located in the following directory:</p>

<p><tt></tt><i>tut-install</i><tt>/examples/cdi/simplegreeting/web</tt></p>

<p>The simple CSS file that is used by the Facelets page is
in the following location:</p>

<p><tt></tt><i>tut-install</i><tt>/examples/cdi/simplegreeting/web/resources/css/default.css</tt></p>



<a name="gjcvh"></a><h3>Configuration Files</h3>
<p>You must create an empty <tt>beans.xml</tt> file to indicate to GlassFish Server that
your application is a CDI application. This file can have content in some
situations, but not in simple applications like this one.</p>

<p>Your application also needs the basic web application deployment descriptors <tt>web.xml</tt> and
<tt>glassfish-web.xml</tt>. These configuration files are located in the following directory:</p>

<p><tt></tt><i>tut-install</i><tt>/examples/cdi/simplegreeting/web/WEB-INF</tt></p>



<a name="gjcym"></a><h3>Building, Packaging, Deploying, and Running the <tt>simplegreeting</tt> CDI Example</h3>
<p>You can build, package, deploy, and run the <tt>simplegreeting</tt> application by using either
NetBeans IDE or the Ant tool.</p>



<a name="gjcxp"></a><h4>To Build, Package, and Deploy the <tt>simplegreeting</tt> Example Using NetBeans IDE</h4>
<p>This procedure builds the application into the following directory:</p>

<p><tt></tt><i>tut-install</i><tt>/examples/cdi/simplegreeting/build/web</tt></p>

<p>The contents of this directory are deployed to the GlassFish Server.</p>

<ol>
<li><b>From the File menu, choose Open Project.</b></li>
<li><b>In the Open Project dialog, navigate to:</b><pre><tt></tt><i>tut-install</i><tt>/examples/cdi/</tt></pre></li>
<li><b>Select the <tt>simplegreeting</tt> folder.</b></li>
<li><b>Select the Open as Main Project check box.</b></li>
<li><b>Click Open Project.</b></li>
<li>(Optional) <b>To modify the <tt>Printer.java</tt> file, perform these steps:</b><ol style="list-style-type: lower-alpha">
<li><b>Expand the Source Packages node.</b></li>
<li><b>Expand the <tt>greetings</tt> node.</b></li>
<li><b>Double-click the <tt>Printer.java</tt> file.</b></li>
<li><b>In the edit pane, comment out the <tt>@Informal</tt> annotation:</b><pre>//@Informal
@Inject
Greeting greeting;</pre></li>
<li><b>Save the file.</b></li></ol></li>
<li><b>In the Projects tab, right-click the <tt>simplegreeting</tt> project and select Deploy.</b></li></ol>

<a name="gjczt"></a><h4>To Build, Package, and Deploy the <tt>simplegreeting</tt> Example Using Ant</h4>
<ol>
<li><b>In a terminal window, go to:</b><pre><i>tut-install</i>/examples/cdi/simplegreeting/</pre></li>
<li><b>Type the following command:</b><pre><tt><b>ant</b></tt></pre><p>This command calls the <tt>default</tt> target, which builds and packages the application into
a WAR file, <tt>simplegreeting.war</tt>, located in the <tt>dist</tt> directory.</p></li>
<li><b>Type the following command:</b><pre><tt><b>ant deploy</b></tt></pre><p>Typing this command deploys <tt>simplegreeting.war</tt> to the GlassFish Server.</p></li></ol>

<a name="gjcze"></a><h4>To Run the <tt>simplegreeting</tt> Example</h4>
<ol>
<li><b>In a web browser, type the following URL:</b><pre>http://localhost:8080/simplegreeting</pre><p>The Simple Greeting page opens.</p></li>
<li><b>Type a name in the text field.</b><p>For example, suppose that you type <tt><b>Duke</b></tt>.</p></li>
<li><b>Click the Say Hello button.</b><p>If you did not modify the <tt>Printer.java</tt> file, the following text string appears below
the button:</p><pre>Hi, Duke!</pre><p>If you commented out the <tt>@Informal</tt> annotation in the <tt>Printer.java</tt> file, the following
text string appears below the button:</p><pre>Hello, Duke.</pre></li></ol>
         </div>
         <div class="navigation">
             <a href="gjbls.html"><img src="graphics/leftButton.gif" border="0" alt="Previous" title="Previous"></a>
             <a href="p1.html"><img src="graphics/upButton.gif" border="0" alt="Contents" title="Contents"></a>
             <a href="gjcxv.html"><img src="graphics/rightButton.gif" border="0" alt="Next" title="Next"></a>
         </div>

         <div class="copyright">
      	    <p>Copyright &copy; 2011, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></p>
      	 </div>

      </td>
   </tr>
</tbody>
</table>
</body>
</html>

